home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Network Supervisor's Toolkit
/
Network Supervisor's Toolkit.iso
/
administ
/
nodeinfo
/
readme
< prev
Wrap
Text File
|
1996-07-10
|
26KB
|
577 lines
NodeInfo v1.2x
--------------
The following notes are specific to the NodeInfo utility (NODEINFO.EXE)
developed by Avanti Technology, Inc.
STATEMENT OF TITLE AND WARRANTY
-------------------------------
NodeInfo (the Software) was developed by and is the property of Avanti
Technology, Inc., of 13492 Research Boulevard, Suite 120-271, Austin,
Texas 78750 USA (Avanti). All rights are reserved worldwide under both
Federal and International Copyright Laws. No distribution or use of the
Software in any form relinquishes Avanti's claim to ownership and title
of the Software and concept.
Avanti warrants that the Software, when used as intended, is free from
known defects at the time it was distributed. Should a defect become
evident, a detailed report of the conflict or anomaly should be provided
to Avanti. Upon confirmation of the report, Avanti will endeavor to
correct the problem and make the correction available to registered users.
If a registered user encounters a defect within the initial ninety (90)
days following original receipt of the software which Avanti is unable to
rectify, the software may, at Avanti's sole discretion, be replaced or
arrangements made for a refund of the license fee.
Avanti shall not be required to insure the compatibility of the Software
with future revisions to the workstation or network operating system, nor
the hardware on which it may be installed. Nevertheless, Avanti reserves
the right to enhance, update, or change the Software in ways which may
alter its specification, operation, performance, and/or support levels.
However, such a modification does not obligate Avanti to continue doing
so. Registered users of the Software may be eligible for such revisions
provided they adhere to the terms of the Software License Agreement
accompanying the Software.
NOTICE OF DISCLAIMER
--------------------
AVANTI TECHNOLOGY, INC. SPECIFICALLY DISCLAIMS ALL OTHER WARRANTIES
IMPLIED OR EXPRESSED, INCLUDING BUT NOT LIMITED TO, IMPLIED WARRANTIES
OF MERCHANTABILITY AND ANY IMPLIED OR EXPRESSED WARRANTY FOR PARTICULAR
USE. IN NO EVENT SHALL AVANTI TECHNOLOGY, INC. BE LIABLE FOR ANY LOSS
WHICH IS GREATER THAN THE LICENSE FEE PAID BY THE REGISTERED USER.
AVANTI TECHNOLOGY, INC. SHALL NOT BE LIABLE UNDER ANY CIRCUMSTANCES FOR
DIRECT, INDIRECT, OR SPECIAL DAMAGES RESULTING FROM THE USE OF THE
SOFTWARE (some of these exclusions may not apply in some states).
Overview:
---------
NodeInfo is a utility designed to help manage users and
files on NetWare v2.1x, v2.2, v3.1x, and v4.0x servers,
including 500 and 1000 user versions of NetWare. As a
client utility, it provides a visual map showing the
number of active connections, logged in users, and open
file activity. It can be used to identify connections
where users are logged in, find a connection by its node
ID, locate connections accessing a specific file, check
record locks against a file, send messages to individual
or groups of connections, and to clear individual or
groups of connections.
It can also be used as a batch utility to identify, alert,
and clear connections prior to performing critical tasks.
(Note: NetWare v4.0x support requires Bindery emulation.)
Usage:
------
Copy the NodeInfo files from the distribution media to
any destination directory. While users can run NodeInfo,
clearing connections requires SUPERVISOR rights and most
file access information requires File Server Console
Operator status (granted through the Supervisor Options
in SYSCON). Attempts to perform tasks in excess of the
user permissions will be trapped and the user informed.
Note: Upon registering a licensed copy of the software,
a bonus NLM (NODEINFO.NLM) will be provided which
can be configured to grant users temporary Console
Operator status to users while in NodeInfo under
NetWare v3.1x/v4.0x. This temporary status grants
them the ability to view who has files open but
not the ability to clear connections. The licensed
version of the software also allows the visual map
update frequency to be selected from among 15, 30,
and 60 second intervals (default is 30 seconds).
Both of these features are configured through the
CONFIG or RECONFIG command line options. However,
the granting of temporary FS Console Operator status
only works when the NODEINFO NLM is loaded on the
NetWare v3.1x/v4.0x server in use.
The following command line options may be specified:
SET | MARK - mark all active connections
RESET | UNMARK - unmark any previously marked connections
F=[sys:path\file.ext] - mark connections with specified file open
(vol:path\file.ext specification required -
wildcards allowed in file.ext)
G=[group] - mark all connections for [group] members
-G=[group] - unmark all connections for [group] members
(exact [group] name required)
N=[node] - mark connection for the specified node ID
-N=[node] - unmark connection for the specified node ID
(right justified exact match of node ID)
U=[user] - mark all connections for specified user
-U=[user] - unmark all connections for specified user
(left-based match of logged-in/marked users)
M="message" - send message to marked connections
(maximum message length = 55 chars.)
CLR|CLEAR|DEL|DELETE - terminate marked connections
(except program's connection - without
prompts, requires SUPERVISOR equiv.)
LIST - display all marked connections
(useful for reports or action verification)
P=##### - pause the specified number of seconds
R=##### - repeat previous commands for a total
of the specified number of iterations
STATS - displayed counts for Logged In, Logged Out,
Marked, and Inactive connections
BAT | BATCH - process options as batch commands
(processed without operator intervention)
The command line options can be combined. However, they are
processed in the order specified so any action (CLEAR or M=)
or exclusion (-U=) options should be specified last. The results
of any actions or exclusions are displayed on the screen in a
manner which allows them to be redirected (i.e., append '> filename'
to the command line).
Note that unless BAT or BATCH is specified, the program will
merely pre-process the options and load in a manner requiring
operator intervention (i.e., full screen display). Use the
BAT or BATCH options for batch file processing.
Command line option examples:
F=SYS:MAIL\MAIL.DAT U=GUE M="Please logout!" BAT
Mark all connections which have SYS:MAIL\MAIL.DAT open or
are logged in under a user name beginning with GUE and
send them the message "Please logout!". Process the
options as batch commands (i.e., terminate the program
once processed).
G=E_MAIL -U=MAIL_ADMIN M="Logout NOW!" P=60 RESET R=5 DEL BAT
Mark all connections where the logged in user is a member
of the GROUP E_MAIL. Unmark any connections where the USER
MAIL_ADMIN is logged in. Send remaining marked connections
the message "Logout NOW!" Pause 60 seconds, reset any marked
connections, and repeat the previous operations for a total
of 5 iterations then clear any remaining marked connections.
Process the options as batch commands (i.e., terminate the
program once all options are processed).
F=SYS:MAIL\MAIL.* F:=SYS:MAIL\USR*.* -U=MAIL_ADMIN CLEAR BAT
Mark all connections which have SYS:MAIL\MAIL.* or
SYS:MAIL\USR*.* open. Unmark any connections where the USER
MAIL_ADMIN is logged in. Terminate the marked connections.
Process the options as batch commands (i.e., terminate the
program once processed).
N=00608C116F2A
Mark the connection with the specified node ID. Load in
normal interactive mode with the marked connection flashing
on the connection grid.
F=SYS:MAIL\*.*
Mark all connections which have any files open in the
SYS:MAIL\ subdirectory. Pre-process the options before
loading in normal interactive mode. Marked connections
will be flashing on the connection grid.
In addition to being supported in the Main screen, the '?'
key can be pressed in the following situations:
- In the Main screen to show this help information, plus the
following areas within the Main screen:
- At the Change Servers prompts to provide explanations
- At the Find File prompt to show usage examples
- At the Find Node prompt to show usage examples
- At the Find User prompt to show usage examples
- In the User Information screen to show file attribute explanations
- In the Reconfiguration screen for both the Update Interval and
the Enable/Disable temporary FS Console Operator status prompts
- In a help screen to show Technical Support contact information
- In the Technical Support contact screen to show a NodeInfo overview
- In the NodeInfo overview screen to show information on ordering
Pressing Up, Down, PgUp, PgDn, Home, and End will move through those
help screens with multiple pages. Escape exits the help subsystem.
A description of the keys supported in the Main screen follows:
Cursor Movement: Up, Down, Left, Right, Home, & End
Tab: jump to next logged in connection
Shift-Tab: jump to previous logged in connection
Ctrl-Right: jump to next marked connection
Ctrl-Left: jump to previous marked connection
PageUp: previous block of nodes (500 & 1000 user NetWare)
PageDown: next block of nodes (500 & 1000 user NetWare)
Enter: additional user/open file details - Req. Console Operator status
('?' will provide another help screen for this option)
Ins: change to a different file server
(press Ins a second time to bring up a list of known servers)
Del: clear current/marked connections - Requires SUPERVISOR rights
(if none are marked, only the current connection is cleared)
Ctrl-Del: clear only the current connection (even if others are marked)
F1:* mark conns accessing a file - Requires Console Operator status
(vol:path\file.ext required - wildcards allowed in file.ext)
F2:* locate an active connection by its six byte node ID
(left-based search - i.e., 00008C116F2A & 8C116F2A are equal)
F3:* mark all connections where a specified user is logged in
(left-based search - i.e., SU & SUPER match SUPERVISOR)
F4: send a NetWare message to current/marked connections
(if none marked, only the current connection is notified)
Ctrl-F4: send only to the current connection (even if others are marked)
F5: toggle (mark/unmark) this connection
F6: toggle (mark/unmark) all connections
(if none marked, mark all - if any marked, clear all)
* [Note: Previously marked connections are not cleared first.]
The following connection information is shown on the main screen:
Logged In (###) - number of logged in connections
Logged Out (###) - number of logged out connections
Inactive (###) - number of unused connection slots
If the currently positioned connection has any files open on this
server, a subset of up to 11 actively open file names will appear
left portion of the screen. If there is a dash (-) before the
file name, it indicates the file is open in a restricted access mode
(i.e., limited other users read or write access). If there is a plus
(+) before the name, it indicates the file is locked by the connection.
Example: TEMPFILE.001 - Other users may read & write this file
-TEMPFILE.002 - Other users have restricted access to
this file - to check the restrictions,
press Enter to view the full file list
and defined attributes for each file
+TEMPFILE.003 - Locked exclusively by the connection
Only information regarding files residing on the current server is
shown. NodeInfo has no way to report on files residing on other
than the current selected server (i.e., other servers or the local
workstation drives).
The following details about the connection number are also shown:
[login name]: If a connection logs out while the program is running,
it saves the name for reference. Otherwise, logged out,
as well as inactive, connections show [NOT-LOGGED-IN].
Node: net:node address (Note: [N/A, possibly non-PC] is
usually a Mac and internal NLM connections often
return invalid net:node addresses)
Status: Inactive - not an active connection
Normal - normal operation
File Lock Wait - wait on file lock release
Logical Rec Lock Wait - wait on logical lock release
Physical Rec Lock Wait - wait on physical lock release
Semaphore Wait - wait on semaphore lock release
Type: 01 - User - normal User connection
05 - Job Server - Job Server connection
07 - Print Server - Print Server connection
09 - Archive Server - Backup/Archive Server conn
[various others or UNKNOWN if not recognized]
Service Requests: Total number of NCP requests made by this node since
it attached to the File Server. This count does not
reset when a new User logs in, only if the connection
becomes inactive (i.e., once cleared by the watchdog).
Disk Usage (Kb): Total KBytes of disk space assigned on the File Server
for this User. This is the cumulative space allocated
to all files for which this User is the owner.
(Note: This is not available for NetWare v2.1x/v2.2.)
Read KBytes: Total KBytes of file read requests made by this User
since logging into the File Server.
Write KBytes: Total KBytes of file write requests made by this User
since logging into the File Server.
Licensing:
----------
Avanti Technology, Inc. offers NodeInfo as a licensed software
product with continuous right to use so long as the registered
user remains in adherence to the terms and conditions of the
Software License Agreement. NodeInfo is available under two
licensing methods:
Site License at $95.00/Site
- or -
Corporate/Organization License at $395.00/Organization
(Note: Introductory pricing only in effect for the first
90 days after the initial product release.)
Under both licensing methods, the user is provided with free
technical support for the product and free upgrades for the
first year after registration. Upgrades after the first
year are available at the then current fee schedule which
may vary based upon the licensing method.
Prices quoted are pre-paid in US Dollars, excluding any
applicable sales taxes or export duties. The license
fee includes software delivery via ground services within
the continental United States (call for quotes on express
or non-continental U.S. delivery). The availability of
credit terms and invoicing is at the sole discretion of
Avanti Technology, Inc.
System Requirements:
--------------------
The NodeInfo NLM requires NetWare v3.11, v3.12, or v4.0x.
CLIB v3.11 rev D or later is required for the NodeInfo NLM
(provided to registered users) to run under NetWare v3.11.
The standard CLIB which ships with NetWare v3.12 or v4.0x
will support this NLM.
NetWare v4.0x support requires active Bindery emulation.
Full NetWare v4.0x support requires File Server Console
Operator rights (assigned or temporary). This is due to an
anomaly in Novell's support for File Server Information NCP
queries which requires such rights in order to properly ascertain
the maximum number of active user connections which can be
supported by the copy of NetWare in use. Under NetWare
v2.1x, v2.2, and v3.1x, such information is available to
any attached workstation. However, NetWare v4.0x requires
special access rights to determine this basic, non-security
related, information.
Technical Support:
------------------
In order to provide the best and most expedient technical
support possible, it is requested that the following information
be known prior to initiating technical support contact:
Workstation: DOS, IPX/NETx, or VLM versions, plus free RAM size
File Server: NetWare version and CLIB revision (if NetWare v3/v4)
In addition, the more indepth the problem can be described & isolated
(including any error message), the greater the chances are for quick
resolution. The following means may be used for technical support:
Mail: Avanti Technology, Inc.
13492 Research Boulevard
Suite 120-271
Austin, Texas 78750 USA
Telephone: (+1)512/335-1168
08:00 to 16:00 (US Central time zone)
Facsimile: (+1)512/335-7838
CompuServe: 76517,3117
Release Notes for v1.25:
------------------------
- Added support for the STATS option to display the Logged In,
Logged Out, Marked, and Inactive connection counts
- Added support for -G=[group] command line option to unmark/exclude
connections which are a member of the specified group name
(Note: The exact [group] name is require, e.g., -G=EVERYONE )
- Added support for -N=[node] command line option to unmark/exclude
the connection for the specified node ID
(Note: The check is a right justified exact match of node ID)
- Changed the X=[user] command line option (unmark/exclude all
connections for the specified [user]) to utilize -U=[user]
- Modified the Open Files list logic so that it does not require
the allocation of temporary directory handles which sometimes
failed due to problems with some of Novell's NetWare shells
Release Notes for v1.24:
------------------------
- Added 'Processing command line options...' message for
display during BAT | BATCH processing
- Added support for Ctrl-Del to CLEAR only the current pointed
connection (even if other connections are marked)
- Added support for Ctrl-F4 to SEND only to the current pointed
connection (even if other connections are marked)
- Changed banner display logic so it is not written to the file
when used in BATCH mode with the output being redirected
- Corrected a logic problem which could keep a SEND message from
being sent to an unmarked connection when individually selected
- Corrected a logic problem which could cause the file Lock test
to fail (i.e., locked files not properly identified)
Release Notes for v1.23:
------------------------
- Added support for wildcards (* and ?) in the file.ext portion
of the vol:path\file.ext file specifications for open file searches
- Added support for the following command line options and batch
processing functions ( [] are for example only, "" are required ):
SET | MARK - mark all active connections
RESET | UNMARK - unmark any previously marked connections
G=[group] - mark connections who are members of [group]
X=[user] - exclude (unmark) specified [user] from actions
P=##### - pause processing for ##### number of seconds
R=##### - repeat previous options for a total of
##### iterations
LIST - display a list of the marked connections
- Changed support for ALL | MARKALL option to SET | MARK
Release Notes for v1.22:
------------------------
- Further optimized code towards incorporating command line options
and supporting batch file processing
- Added support for the following command line options and batch
processing functions ( [] are for example only, "" are required ):
ALL | MARKALL - mark all active connections
F=[sys:path\file.ext] - mark connections with specified file open
N=[node] - mark connection with specified node ID
U=[user] - mark connections for specified user
M="message" - send message to marked connections
CLR|CLEAR|DEL|DELETE - terminate marked connections
BAT | BATCH - process options as batch commands
Release Notes for v1.21:
------------------------
- Hand coded around a bug in the NetWare Client API SDK which would
result in an error for any connection with more than 22 files open
running under NetWare v2.
(Note: The SDK built a reply buffer to retrieve the open file
information in blocks of records. A bug in the SDK Library causes
it to allocate too small of a buffer resulting in an error.)
- Hand coded around a bug in the NetWare Client API SDK which would
result in incomplete open file information for a connection with
more than 17 files open running under NetWare v3/v4.
(Note: The SDK retrieves open file information in blocks of 17
records. A bug in the SDK Library results in the information
for the first file in each supplemental block, after the initial
request for the first 17 files, being skipped.)
Release Notes for v1.20:
------------------------
- Added support for granting temporary File Server Console Operator
rights under NetWare v4.0x to the NLM and NodeInfo which is
distributed to registered users
- Added support for Disk Space in Use to the NetWare v3.1x/v4.0x
NLM and NodeInfo which is distributed to registered users
- Added support for NCP Requests to the NetWare v3.1x/v4.0x
NLM and NodeInfo which is distributed to registered users
- Added support for file Bytes Read to the NetWare v3.1x/v4.0x
NLM and NodeInfo which is distributed to registered users
- Added support for file Bytes Written to the NetWare v3.1x/v4.0x
NLM and NodeInfo which is distributed to registered users
Release Notes for v1.10:
------------------------
- First commercial release of the NodeInfo utility
- Modified connection update logic to handle the difference in
how NLM connections are managed between NetWare v3 and v4
- Modified connection update logic to work around a NCP change in
NetWare v3.12/v4.0x which returns an Invalid Connection error
(even when within the supported connection count range) if an
inactive connection is queried (no previous NetWare versions do
this - this change also affects older versions of FCONSOLE)
Release Notes for v1.09:
------------------------
- Added support for 500 and 1000 user versions of NetWare
- Further expanded the on-line help information
- Corrected a logic oversight which would cause indeterminate
results in the User Information screen if one of the connection's
open files included either a subdirectory or file name that
had a numeric digit as the first character
Release Notes for v1.08:
------------------------
- Through debug, isolated the anomaly in Novell's NetWare Client
API for C libraries so that support for NetWare v2 record lock
information could be properly supported
- Optimized the file attribute routine for NetWare v2 support
- Recompiled with latest release of Novell's NetWare Client API
for C libraries (v1.00e - Beta)
Release Notes for v1.07:
------------------------
- Added a configuration option to change the Update Interval
for the visual map of connections (default is 30 seconds,
supported intervals are 15, 30, and 60 seconds).
- Added confirmation prompt prior to performing Clear Connection
- Added support for Home, End, Page Down, and Page Up for scrolling
through the open files list in the User Information screen
- Cosmetic adjustment to screen colors based upon user feedback
- Expanded the help system functionality and information
- Further optimized some of the functions
- Corrected a logic oversight which would not recognize NetWare v4.0
ADMIN users as Supervisor Equivalent or a FS Console Operator
Release Notes for v1.06:
------------------------
- Corrected a cosmetic display problem in the User Info screen
where scrolling through a file listing could cause the
attribute information for the top file listing to disappear
- Corrected a logic problem in the User Info screen which
occurred during the resolution of long file names that could
cause the program to terminate (due to failure of either
the Physical Lock Scan or the Temporary Directory Allocation)
Release Notes for v1.05:
------------------------
- Added a configuration option (CONFIG or RECONFIG command
line options) to the registered version which can provide
users on NetWare v3.1x with temporary File Server Console
Operator status when running NodeInfo with the NLM loaded
- Added display of current counts to Logged In, Logged Out, &
Active icons on the Main screen
- Added display of restricted access(-) and locked(+) status
icons to the Open Files subwindow on the Main screen
- Added display of record lock and access control attributes
to the files listed in the User info screen
- Added file access verification logic to the Find File option
- Added the ability to locate connection by its 6 byte Node ID
- Expanded the on-line help functionality and information
Release Notes for v1.04:
------------------------
- Corrected a problem in Send Message which could cause it
to send messages to inactive nodes
Release Notes for v1.03:
------------------------
- Added real-time clock to screen display
- Added 'Updating' message when remapping conns on large net
Release Notes for v1.02:
------------------------
- Added support for foreign device identification (MACs)
- Added support for Ctrl-Left & Ctrl-Right cursor movement
to move between marked nodes
Release Notes for v1.01:
------------------------
- Added the ability to attach/login to other known servers
Release Notes for v1.00:
------------------------
- Initial limited release of the NodeInfo utility